Les « tags »

Dans la documentation, les tags permettent de créer des liens entre toutes les pages, ainsi une page sans tags est une page qui sera très peu consultée et donc inutile à moins d'avoir d'autres pages qui pointent vers elle, c'est pourquoi il est nécessaire d'ajouter le champ des tags avec les tags appropriés, bien évidement avec une orthographe correcte (accents y compris) et au singulier.

Ces tags permettent de construire des portails associés où toutes les pages présentant un tag sont listées.

Pour utiliser des tags (mots-clés) dans les pages du wiki :

{{tag>liste des tags}}

Les tags de cette liste des tags sont séparés par des espaces. Pour inclure une espace dans le nom du tag, remplacez-la par un tiret bas. Vous pouvez voir une liste des tags utilisés dans la documentation sur la page catégories.

• Les tags devant être accentués le sont. Exemples : matériel, système, sécurité, etc.

{{tag>matériel système sécurité}}

• Les tags doivent être intégralement écrits en minuscule, excepté le tag « BROUILLON » afin qu'il soit visible. Les tags des versions d'Ubuntu peuvent prendre une majuscule.

• Les tags de versions (Dapper, Jaunty, Karmic, Lucid, Maverick, …) correspondent aux versions pour lesquelles la page est valide; ils sont utiles pour toutes les pages de la documentation sauf les portails. On utilise uniquement l'adjectif du nom de code de la version.

• Les tags doivent suivre l'ordre suivant :

{{tag><Versions> <domaine_principal> <domaines spécifiques> <autres_tags> <tutoriel si c'est un tutoriel ou autre> BROUILLON}}

• On fait suivre la liste des tags d'un trait pour bien séparer du texte grâce à la syntaxe :

----

Ce qui donne

Pour le fonctionnement interne de la documentation certains tags peuvent être placé sur des pages spécifiques afin d'attirer l'attention.

Ces tags sont :

• Brouillon – pour les pages en cours de rédaction,
• vétuste – pour les pages n'ayant pas d'informations récente et n'ayant pas été validée pour une version encore supportée,
• à_supprimer – pour les pages que l'ont pense supprimer mais auquelles ont attend une éventuelle ré-écriture.

Voir le chantier des tags

Pour lister les pages ayant un tag particulier utilisez cette syntaxe :

{{topic>nom_du_tag}}

Si vous venez d'ajouter un tag à une page et qu'une page listant les pages contenant ce tag via « le wikicode topic » ne contient pas votre page, cela est peut-être du au fait que votre page ne contient pas de titre de niveau 1. Veillez à bien structurer votre page de manière sémantique (c'est-à-dire avec des titres, etc.).

D'autres syntaxes sont également possibles :

{{topic>tag1 +tag2}}           (tag1 ET tag2)
{{topic>tag1 -tag2}}           (tag1 SAUF tag2)
{{topic>tag1 tag2}}            (tag1 OU tag2)

Pour plus de détails, se référer à l'aide de l'élément Topic sur DokuWiki.